package com.naiterui.ehp.bs.wechat.service;

/**
 * @author zhoupeipei
 * @date 2019-06-24 16:18
 * @since 1.0.0
 */
public interface IWebAuthorizeApiService {
    /**
     * 获取web授权url-静默方式，无需用户同意授权。一般为已关注公众号用户可看到的入口，如菜单、模板消息
     *
     * @param redirectUrl 授权后请求地址
     * @param params      透传参数信息，只支持a-zA-Z0-9
     *
     * @return
     */
    String getWebAuthorizeUrlSilent(String redirectUrl, String params);

    /**
     * 获取web授权url-静默方式，A标签方式
     *
     * @param redirectUrl 授权后请求地址
     * @param params      透传参数信息，只支持a-zA-Z0-9
     *
     * @return
     */
    String getWebAuthorizeUrlSilent(String redirectUrl, String params, String hrefText);

    /**
     * 获取web授权地址-需手动授权。可以用于分享链接，用户授权后可以获得新用户更敏感的信息，如unionId
     *
     * @param redirectUrl 授权后请求地址
     * @param params      透传参数信息，只支持a-zA-Z0-9
     *
     * @return
     */
    String getWebAuthorizeUrl(String redirectUrl, String params);

    /**
     * 通过用户授权code获取用户openId【静默授权】
     *
     * @param code 【默认授权码，有效期5分钟，且只能使用一次】
     *
     * @return
     */
    String codeForOpenId(String code);
}
